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I. General Description 

TECO it s scope-keyboard text-editor. It uses an on-llic corsnand 
language (which permit! macro-definitions, conditional* „ etc.) to control 
Input-output (paper and magnetic tapes, scope* etc.) a* well as text 
operations. The macro language permits the most sophisticated search, match, 
and substitution operations as fweil as simple typographical corrections to 

text. 

The original TECO (Tape Editor an <j Corrector) was e PDP-1 program written 

by Daniel L. Murphy. With the arrive! of a PDP-6 at Project MAC, the need 
was seen for a similar program on the new machine, and PDP-6 TECO waaf 
written by Steward Nelson, Jack Hoiloway, and Richard GreenbUct. Although 
similar to the PDP-1 program in many respects ( there arc countless differences 
in detail; furthermore PDP-6 TECO coomands have undergone several changes 
in their history. Only the 6 July, 1965 version of PDP-6 TECO is described 
herein. Differences between this description and current versions on the 
Systesi Tape will be listed in the Console Book. 

There are three kinds of storage areas within TECO: (1) the buffer; 
{2) the 36 Q-rextsters ; designated 1»..*9, A t B,..<2; (3) the contend string 
area. The buffer at all times contains a (possibly null) character string, 
generally constituting a page of the text being edited. Ac certain tines 
the command-string area contains a string of characters which TECO Interprets 
as a series of commands. Each Q-reglster may: (a) be undefined; (b) contain 
a positive or negative Integer; (c) contain a character string. The buffer 
is that area where text to be edited Is examined and modified; the Q-registers 
are locations for remembering quantities, or strings of text, for Later use; 
Che command string is the area from which TECO takes its instructions. 

Associated with the buffer is the "pointer*': this is a movable flag 
which always sits between two adjacent characters in the buffer (or at either 
end of the buffer). The pointer has a numeric value t equal to the number of 
characters to its left in the buffer* If at the moment there are n characters 
in the buffer, the pointer's value may range from to n. 

A generel description of the usage of TECO is as follows: the user 
gets TECO into the computer; types in commands to describe where the material 
to be edited (the "input") is (either on paper tape or on DECtape as named 
file,) By further commands, he reads the first page into the buffer; 
inspects it on the display and makss changes by typing in comma nils; outputs 
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the page onto paper cape of DECtape, and reads in the next pigc; etc it and 
after out-putting the lest page, if to DECtape he files it, giving the new 
file Its name. This is by no cleans the only way one may proieed. but It Is 
the exist cotemon. 

II- Loading TECO 

The roost recent version exists on the DECtape labelled MACDMP SYSTfM 
■• the file TECO. 

To load It, put the MACDMP SYSTCT tape on a drive, set that drive unit 
to 1, press INSTRUCTION STOP, 10 RESET; act TA to 0; press READ IN. (This 
loads MACDMP.) When the on-line Teletype cai Mage-returns, type TECO 
followed by a carriage return. When the Teletype then line-feeds, TECO 
la In and running, waiting for corrcvinJs. 

III, Typing in Commands 

TECO is always listening for the user to type in commands (except 
during the performance of the VW command; see below). Nearly any string of 
characters may be typed in. If carriage return is typed, TECO l^aginea that 
the user typed a line feed following it. All characters typed in are echoed 
back out by TECO (Including the imagined line feed) unchanged except as 
foljowa; (1) ALT MODE is typed out as §; (2) characters which have no 
vlaible effect and are typed In via the CTRL shift key cone out as ■ 
followed by the appropriate un-CTRL^ character; (3) RUBOUT does not go in, 
but insteed erases the last character that did go in. This echoes out the 
character that has Just been erased. RtfBOUT may be used any number of times 
in a row, the uaer does not pause an instant between RUBOUTs, TECO will 
erase all characters typed, and when the RUBOUTs cease will type carriage 
return- -line feed. This feature oay be used dependably by pressing 
RUBOUT and REPT. (4) Two successive ALT MODEs Indicate the end of the 
string being typed in. When these are encountered, TECO echoes then as Ss* 
type carriage return ■ -line feed, copies the entire string of characters 
typed (except those erased) into the command string area, and starts to 
Interpret and perforin these new commands. The format in which TECO expects 
theee commands, and the actions they direct it to take, comprise the bulk 
of knowledge the user should have about TECO. 



iJltJ.L .. m t J/* 
-4- 



Many TECO commands take argument* with numeric valve*. .»nd some commands 
take different action depending on whether arguments are given or not. 
The following characters ray appear In command strings to develop numeric 
values. Furthermore, some commands, beside directing .action on TECO' * 
part, have a numeric value themselves and so may act a* an argument to a 
aubaeqjent command. If a cormand may have a value, this will be stated In 
its description- In all command description, (s) ;means ALT MODE and fa 
nenas a with the CTRL key held, 
0-9 digits form decinal Integers, 
fi "0 (i.e. returns the numeric value 0) . 

Z ■ number of characters In the buffer. 

* number of characters to left o: the pointer. 
Qi (where 1 is a digit or letter) * numeric value most recently put into 

Q-reglster named I, 
nA (where n Is a numeric argument) * value In 7-bit ASCII of the character 

to the right of the pointer. 

[5* has the value of elapsed time, in 60ths of a second, that TECO has been 

running. 
«n Add' 






1 or 2 arguments 
i-n subtract 



m*a ■uiLipiy eake % argumonC8 



m/n divide (truncates); 

mfri logical and: bitwise an d of binary representations of n and n. Operators 

+* Z.* *» /* *™* •" performed from left to right. This may be overruled 
' _ fey use of 
() numeric parenthesis. 

n" cauaes the value of n to be typed out. 
nlll puts quantity n in Q-registcr named 1. 

m,n if a command takes two numeric arguments) comma Is used to separate them. 
H an abbreviation for B,2 which is a frequently used pair of arguments for 

coenandej 



t 
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V. Use of Q-Realaters 

tiUI (mentioned in IV.) Puts the numeric value n in Q*regl*tev named ^t 

(where t is a character 0,1,-.. .9, A, B, , .,,Z.) 
Qi (mentioned La IV.) Has the value of the latest quantity put into ()- 

register i± 
i Adds 1 to the quantity in Q-reglstcr i and stands for the new value. 
n,mXl Copies a portion of the buffer into Q-rcgistor i. It sets Q-regiater t 

to duplicate of the (m+lj th through nth character* in the buffer. The 

buffer is unchanged, (for example: HXA puts a replica of the entire 

buffer into Q-regieter A.) 
nXl Into Q-regieter i is copied the string of characters starting iroicdiately 

to the right of the pointer and proceeding through the nth line feed. 
01 The text in Q-r«gister i is inserted into the buffer at the current 

location of the pointer. The pointer is then put Just to the right of 

the insertion. The Q-reglster is not changed. 
It does not make sense to TECO to ''G" a Q-register given a number by "U M nor 
to "Qi or "<i" one given text by "X'\ 

VI. DEC tape Command a 

TECO uses the MAC file structure on DECtape to put on one tape j large 
number of independent ASCII files. For details of this scheme the reader 
U referred to MAC-M-249, "Mac PDP-6 DECtape File Structure. " A "file" is 
in many ways the equivalent of a physical paper tape. Different files are 
distinguished on one DECtape by their names: a file name consists of one 
or two subnamea. Each subname la a string of printing characters (ASCII 
41- through 137a) from one to six characters long; in the case of two 
subnamea, the subnamea are separated by a space. The first xubname may be 
preceded by a space* Each file is in one of four modes. Hie node of a file 
is set ;by DECDMP when it dumps, and by TECO and MIDAS when output is filed. 
Associated with each mode is an identifying character which appears with each 
mode file name in file-directory listings. This character is never input by 
by the user, and le only to provide him with Information about the file. 
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PROGRAM 


MODE or 
OUTPUT 


MODE 

NUMBER 


IDENTIFYING 
CHARACTER 


TECO 


ASCII 


Z 


SPACE 


MACOTP 


OLWP 


I 


: 


MIDAS 

(abaolute 
format) 


SBLK 


2 

■ 


« 


MIDAS 
(r«loc stable 
format) 


RELOC 


3 





In the description* below, in or £ signifies a file name of one or two 
sub names; u and v signify a DECtape unit number which must be given In the 
command; and o signifies iq optional DECtape unit number--- if not given, 
the most recent unit mentioned by explicit number or filed upon Is assumed* 
oERrmi(2) Prepare to read file nm fro© the tape on unit o* 

oEI Prepare to put output onto tape o. DECtape output since 

last EF is forgotten- 
oEFnsi(£) Consider all DECtape output since last EP or EI on file , 

with the name nm. The argument n Is ignored, and the 
file Is written out on the tape having received the most 
recent EI* The EF command also copies onto the tape 






the results of previous EN and ED commands regarding 



that tape. 



oEDnm \%J Delete file nm from the file directory In menory for 

cape o. This must later be followed by EC or EF on 
the seme unit to mark the deletion on the tape* 

u£C Copy out file directory from core onto tape. Tti*s is 

uaed to flnalltC previous ED and EH operations on chat 
tape* 

u t vEC Write file directory for tape v onto tape u. 

u t 0EC Write empty file directory onto tape u. 

oENnm(g/qp (3) Rename file nm on o with new name qp. An EF or EC 

must follow on same tape* 

i, uENnmQJqpj^) Rename file am to a£ and aet it to mode number 1 . 

uET Load file directory for tape u Into core. This command 

is not essential, since all DECtape commands lead In the 
file directory if it is not already in core. ET has no 
effect at all if the directory is in core. 



! 
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oEL List the file directory for unit o on th* on-line 

Teletype* A number after the file name :e its lenr.ch 
in blocks. 

uEK Delete file directory for unit u from core. This ha* no 

effect on the tape. 

o/U Display file directory on scope. Upper half of display 

has space for each block on the DECtape; Block 1 in 
tho upper left, block 2 to its rifcht, etc. A blank space 
indicates a free (currently unused) block: otherwise!- the 
space will contain a decimal number* related to tho file 
name by the chare in the lower part of the display. 
That chart gives for each file: file nunber. mode char- 
acter, 1st aubname V<Oit only one suhnene) t 2nd mibnamc* 
length in blocks. The /U command should be thi* last tn 
a corcmand string; the file-directory display goes nwny 
when any new command string Is put in. 

VII* Input Command a 

Upon loading TECO. paper tape Input is initially selected. 

oERnm(§) (explained in VI*) Prepare to read file m from DECtape 

unit o. ER turns on DECtape input and turns off paper 

■ 

Cape input . 

/Q Prepare to read from DECtape. 

/S Prepare to read from paper tape. This command la needed 

only to counteract ER or /Q- 

/C Clear paper tape reader buffer. The l-o routines read 

more paper tape than the user asks for, sequestering the 
yet uncalled-for text in a "buffer" area which can be 
voided with /C. 

Y Render the buffer (not the "reader buffer") e*pty* then 

read into the buffer from selected input file (paper tape 
or file on DECtape) through the next FOW character. 
That FORK does not enter the buffer. The pointer lb left 
at (the beginning of the buffer). If there is no FORM 
character in the input t it is read until an end of flic 
is encountered: this is the end of the physical paper 



tape, or ~he end of a DECtape file. 
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A Append to the end of the buffer from the selected Input, 

through the next FORM or end-of-flle. The pointer is 
not moved by A. 

Icext $ Insert, at the current pointer location, the text follow* 

ing the I up to but not Including the first ALT MODE. 
The pointer Is put to the right of the Inserted material. 

t IJtexCJ (this isfl, not /I,) Insert, at the current pointer 

position, the text surrounded by Instances of the terming 
tor J. which ttsy be at the user's choice any character 
not appearing In the text* The pointer is put to the 
right of the insertion. 

nl Insert et the pointer a character whose 7-bit ASCII code 

it n (base 10). The pointer is moved to the right of 

the new character. 

■ . 

VIII, Output CosJBiands 

Upon loading TECO, output is selected for paper tape alone. 

oEI (Explained in VI.) Prepare tape _ for output. This 

command must be given before any output is done to that 
tape. EI turns on DECtape output and turns off paper 
tape output, 
!y_ Turns on DECtape output. Obsolescent comand. 

/¥ Turns off DECtape output. 

/K Turns on paper tape output. Notice chat both psper and 

DECtape may simultaneously receive the same output. To 
select this, give the /R command after the EI. 
/T Turns oif punched cape output. 

/g Turns on line printer output (that is. if you have a line 

printer). This is independent of paper tape and DECtape 
output. 
/B Turns off line printer output. 

nV Displays on the scope the n lines to the right of the 

pointer, i.e. from the pointer through the nth following 
line feed- If n is aegative. n Unas to the left of the 
pointer are displayed* 
V Same as IV. 

isJV Display the (l+l )th through Uh characters in the buffer. 



'**. 






Notes on Che V conraand: the display ceases If the V Is not the last 
■:.:tj::- of Che command itring^ end when a new command string is entered. 
Usually V la not needed, since whatever not processing comnd*.ad* TECO auto- 
matically displays 20 lines on each side of che pointer (except of the last 
command It saw was V or /_U) . In all displays of Che buffer, the pointer ts 
displayed as a flashing vertical bar, unless it Is not in the rang* being 
displayed ££ is at the end of the buffer* Non-printing characters are 
displayed as follows: space, tab, carriage return, and line feed have their 
usual effect; BELL appears as a bell symbol; others appear as •V followed by 
a subscript which is their 7-bit code In ocCdl, 
n /.M Set number of lines automatically displayed on each side 

of pointer to n. 
h/D SeC display size ton. Legal sizes are 0, 1* 2, and 3: 

1 is che usual size, 2 is appropriate Co demonscrations 

to groups, is too snail and 3 is too big. /_D affects 

V and VW commands, but not {V* 



nVW S 
VW > 



Same as similar form of V except: when this command is 

encountered, the display Is maintained and further ccronands 

in the string are not interpreted until the user types 

in a characcer. Then che display ceases, the VW is 

treated as a numeric quantity equal to the 7-bit ASCII 

code of Che character Just typed in, and command inter- 

pretatlon resumes* (See Example 6.) 

nT Tyfe out the string of characters starting at th** right of 

the pointer and continuing through the nth line feed 

encountered. If n Is negative, n lines to the left of 

the pointer are typed, 

T Same as IT. 

i 

IpJT Type out the (l+l)ch through che Jth character of che 

buffer. 

Notice that T la idenclcal Co V, excepC that ic uses the Teletype Instead of 

che scope* Observe also why HT types out the entire buffer. 

PW Output the entire buffer, followed by a FORK character, 

to che selected output devices (paper cape punch, DECtape* 

line printer). Buffer is unchanged and pointer Is unmoved- 
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P Is identical Co PWY. 

nP la identical to PP...P (P perforijed n tinea), 

i,JP Outputs Q+l)th through Jth characters of buffer. Ko 

FORM Is put st the end. Buffer unclianged; pointer 

unmoved. 
nF The paper tspe punch food: n characters of blank Cape. 

o£Fnm(£) (Explained In VI.) Tile DKCt^pc output with name m. 

This command should be given After cue data is comprise 

a OECtope file has be*n output. 

ix. B ssic Editing Basaia 

nJ Move the pointer to the riffht of the Jth character in the 

buffer. (I.e. give M ." the value n.) 
J Seme es 0J« 

nC Seme as .+nJ. Kote that n may be negative 

rJL Same as .-nj . 

If n 0! move pointer to the ri^h, stopping when It 
has passed over n line feeds. 
nL ) If n 0: move pointer to the left; stop when It has 

passed over n*frl line feeds and then move it 
to the right of the last line feed passed over. 
L Same as 1L . 

nD Delete /n/ characters from the buffer: if n is positive, 

delete then Just to the right of the pointer; if n Is 
negative, delete then Just to Its left. 
oK Perform nL> but delete everything the pointer moves over, 

o.nK Delete the (m+l)th through nth character from the buffer. 

The pointer is then put where the deletion took place. 
m,nXt (Explained in V,) The string from character mH through 

character n of the buffer !■ copied into Q~rcRister X* 
Itext © f (Explained in VII.) Inserts text in buffer at pointer; 

11] teat J 1 puts pointer to right of Insertion. 

nl (Explained in VII.) Inserts character whose 7-bit ASCII 

code is n at pointer; puts pointer at right of new 
character. 



; 
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Cl (Explained in V.) Inserts at the pointer a copy uf the 

t*)XG in Q-regiscer i- The pointer Is set at the right of 
the Insertion* 

X. Search Commands 

There are three search commands: S, tf, and +— * Each of these imiy be 
preceded by either or both of the modifier characters; and T" . Preceding 
the command letter, but following any modifiers, may he a numeric argument; 
If thio is not supplied, I is assumed. Following the command Letter is <* 
text argument in the same format as for the I cr*ft e^flrMnd, depending on 
the absence or presence of the T modifier. If the : modifier Is not used, a 
search cocmand has no numeric value. If : Is used, the value Is -1 if the 
sought material is found and otherwise. 

The search commands attempt Co find In the buffer a match to their 
text argument. The search Is begun at the location of the pointer just 
prior to the search, and proceeds to the right until either a match is 
found or the and of the buffer la reached. If the natch is found, the 
pointer is moved to the right of the string found in the buffer and the 
command Is finished. If the match has not been found, the action depend? on 
whether the comroand was S, N, or ** . The 5 command in such a circurastunce 
la said to fail ; the N command performs a P, and then resumes searching; 
the s^-coonand performs a Y and resumes the search. If N or *- reaches the 
end of the file without finding the match, they fall. If a search falls 
(S reaches the end of the buffer; or N or <- reaches the end of the file*) t 
the pointer is left at the end of the buffer. Then if the : modifier was 
not specified, TECO types out a question mark and Ignores the remainder 
of the command string. 

Should a numeric argument precede the command letter, this is equivalent 
to writing out the entire search command a nuttber of times equal to the value 

of the argument. In other words, If the; number Is n it searches for the 
nth following instance of the text. 
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SEARCH SUMMARY 



All searches begin at ths current location of Che pointer. They may 
include a numeric argument n saying to search for the nth occurrence of 
the text. The pointer is left to the right of the string found If the 
search is successful; otherwise at the end of the buffer- Use of the 
modifier determines the form of the text argument which follows the co*>*and: 
if T JtextJ where J is any character not in text 

if no t text© where text contains no ALT MODE 



CCWMAMD 


Action at 


Action at 


Value 


Value 


Type ? 




end of 


end of 


•hen 


when 


when 




buffer 


file 


success 


falls 


fails 


S 


fells 


can't 
reach it 


none 


none 


yes 


:$ 


falls 


can't 
reach It 


-1 


$ 


no 


M 


P, resume 
starch 


fail 


none 


none 


yes 


:■ 


P, resume 
search 


fall 


-1 


t 


no 


*- 


¥, resume 
search 


fail 


none 


none 


yes 


£ J 


Y t resume 


fall 


-1 


* 


no 


^ 


search 
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Xlt Macros, Iteration* and Conditional^ 

Ml Perform now the text in Q-register t as i* series of 

command*. 
' ~7 r Iteration brackets* When the / is encountered , cortTJiaiv! 

interpretation is sent back to the < . 
n; Iteration test. If the value of n is negative, this 

command has no effect. If n is or greater > command 

interpretation is sent just past the matching ^>Co the 

right. 
: If the most recent search failed, send commend to first 

unfastened /to the right. Otherwise, no effect* 
Itagt Tag definition. The j:gg is a name for the location 

It appear! in a macro, Iteration, or command string. 
OtagS Co to the tag named tag * The tag must appear in the 

current macro or command string. 
n"G Has no effect If n^tf. Otherwise send command inter- 

pretation to next matching 1 . The *' and ' match similar 

to ( and ) 1 
n"L Send command to matching ' unless n^0. 

n"N Send command to matching ' ur.lese n**0. 

n"E Send command to matching * unless n s 0. 

n"C Send command to matching ' unless the value of n as n 

u-bit ASCII character Is a letter, number. . $ or ^£. 
Exeraplti! 

1) To read and perform a command string from paper cape (assuming paper tape 
input is selected): 

VHX2H2 

2) To count line feeds In the buffer: 

J*Url< :S_ 

3) to replace all instances of JUMPA pith JRST 

J<:SJlHPA(|i - 4DIRST@> 

4) To change , throughout the buffer, A to 8 wherever the A is followed by a 
digit (ASCII code 48 1( j through S?^): 

J<:SA(£t 1A-47 ,, GIA-56"L-1DI8 (§) ' *> 






5) To move the pointer to tht left of -he first character that is not e 
■pice (i.e. to apace it over a row of spaces): 

!HiUO2"El0uBK(£)' 

With complicated loops and Iterations lc is generally wise to perform them 
■■ c aacros, so that their text la In Q-reglsters for debugging and editing, 
v) To move on to a page which one would recognize but can not describe in 
sufficient detail to use N : 
<HVW-127;P> 
A* each page appears on the scope, type In any character except RUBOITT 
(*127_ n ) to proceed to the maxt page, or If this It a page to be edited typo 
Rl/BOVT to leave the Iteration. 

XII , ERRORS 

It It conceded that TECO's error messages are not overly informative. 
Such typed -out consents as TAPE FULL and FILE NOT FOUND are clear enough, 
and are part of the l-o routines rather than TECO proper. For all Illegal 
or meaningless commands TECO types out f and Ignores the remainder of the 
command string, returning to the idel state* At this point the user nwv 
type ? back In, and TECO would then respond by typing out ths coemund 
string, ending with the had command. Search coranands are M bab" If they 
fall and the : modifier was not used. 

There are two occurrences that cause TECO to panic: a) PDL OV 
(pushdown list overflow), TECO types out one bell, gives up the coomand 
string and returns to idel state; b) KON EX MEM (non-exlstant memory 
addressed), TECO types out many bells, goes back to idle. 

XIII- Re turning to MACDMP 

The coemand /C (BELL) will, when performed, return to HACDHP, but it 
will have waited for all of TECO's output to be done. MACtHP will very 
possibly atlll have the file directory of the tape it last referred to-— 
presumably the one off which waa loaded TECO. 
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XIV, Some Simple Examples of Editin g 

1. To duplicate an ASCII paper tape, making no change* In 11 : 

fWM p®(D 

The P command 13 terminated by reading an cnd-cf-flle; U*flS* wan cliOBfln 
as being larger than any reasonable number of pages. 

2. To copy th* file PCM ENC1 on DEC tape 3, putting the new version on t.tpo 
2 with the flic na»r PCM ENG2: 

3ER PCW ENCI(|)ZEIY1W0PEF POl EHG2 g® 

3. S*mo as (2) , but in the new copy change the title line frra 
TITLE P<M1 J. SMITH to TITLE PCW2 W. JONES. 

2EI3ER PCM ENGlfpYNTITLE PGM{£)k12 U, JONGS 
(j)^)(Hete check the correction by looking ^t the svope*} 
1000 PEP PCMENC2^)/yg\C J 

(Check the file directory on the scope to see that PQl EtfC? 
has been added*) 



, ^-— ;*;«.__ . - 
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